home *** CD-ROM | disk | FTP | other *** search
/ Mac Mania 4 / MacMania 4.toast / / Multimedia & Desktop / gsf-pairing-knife / Pairing Knife - Read Me < prev   
Text File  |  1992-06-11  |  5KB  |  134 lines
  1. RELEASE NOTES FOR PAIRING KNIFE
  2.  
  3. This is a utility of the 'one dumb job' variety. It does one job, and
  4. does it fast and with minimal hoorah.
  5.  
  6. Pairing Knife is SYSTEM 7 ONLY. Its only interface is Drag and Drop,
  7. so you cannot use it with earlier Systems. If you double-click on it
  8. from a System 6 machine, you will get an error message and the
  9. software will quit gracefully.
  10.  
  11. To use Pairing Knife _with_ System 7, simply select the files you
  12. want to analyze and drag them on the program's icon or an alias of
  13. it. A new file called "Pairing Knife.TXT" will be created, and your
  14. original source files will remain unaltered.
  15.  
  16.  
  17. What does it do?
  18.  
  19. Pairing Knife does an unbiased kerning pair frequency analysis of
  20. files of type TEXT. Unbiased means that all printing characters (from
  21. ASCII 32 to 255) are considered in the analysis. Kerning Pairs, of
  22. course, are pairs of characters that can appear in text and that can
  23. have kerning applied between them. Frequency Analysis means that
  24. every pair combination is counted each time it appears.
  25.  
  26. Pairing Knife writes a report of the relative frequency of kerning
  27. pair combinations to a TEXT file called "Pairing Knife.TXT". You can
  28. use this file to help establish a kerning strategy.
  29.  
  30. Pairing Knife.TXT issues the report with the pairs sorted in strict
  31. ASCII order. You can use Word or sorting software to sort to another
  32. order. Word will show the list in ascending order of relative
  33. frequency.
  34.  
  35.  
  36. Why does frequency analysis help?
  37.  
  38. As you'll see if you run the software, the slope from least frequent
  39. to most frequent pairs is extreme. Editing the 500 most common pairs
  40. will have a greater effect on the overall appearance of your text than
  41. editing the 500 ugliest pairs - which may not be all that common in
  42. real text. Surely you should go after both, to whatever extent you
  43. can stand, but a knowledge of the relative frequency of a particular
  44. combination can help you make the best use of your time.
  45.  
  46. Take note of these provisos, however:
  47.  
  48. A frequency analysis is only as good as the sample text. If you feed
  49. Pairing Knife poetry when your day-to-day work concerns electrical
  50. supplies, you will learn little of real value. Likewise, if your
  51. sample text is filled with garbage characters, the frequency reports
  52. on those pairs will be skewed.
  53.  
  54. Pairing Knife is treating all instances of tab, return and linefeed
  55. as spaceband characters; all other control characters are ignored.
  56. The first character in a file is presumed to be preceded by a space,
  57. and the last character is presumed to be followed by a space. In no
  58. case, however, will multiple spaces be counted. Thus if you had a
  59. file like this:
  60.  
  61. a
  62. b
  63. c
  64. å
  65. ∫
  66. ç
  67.  
  68. Pairing Knife would issue this report:
  69.  
  70.      1     a
  71.      1     b
  72.      1     c
  73.      1     å
  74.      1     ç
  75.      1     ∫
  76.      1    a 
  77.      1    b 
  78.      1    c 
  79.      1    å 
  80.      1    ç 
  81.      1    ∫ 
  82.         Total Pairs: 12
  83.         
  84.  
  85. Toward a finer balance...
  86.  
  87. I made Pairing Knife unbiased so no one would have to struggle to put
  88. the toothpaste back in the tube. However, a 'biased' analysis is
  89. probably more useful in real life. For that reason, a Torquemada set
  90. called "'Bias' Pairing Knife Sample" is enclosed with this archive.
  91. The set is commented, and you should feel free to adapt it to your
  92. particular circumstances. Only one change bears close scrutiny: all
  93. capitals in the sample are being turned into lower case letters. The
  94. reason for this is that the same one (virtual) kerning pair can turn
  95. up in three permutaions (for example, 'aw' can show up as 'AW', 'Aw'
  96. or 'aw'). In reality, if _any_ of those turn up a lot in the sample,
  97. then _all_ of them will turn up a lot in real text. In consequence,
  98. you would want to kern all three, even if 'AW' is relatively rare in
  99. the report. But an unbiased report might fail to make manifest the
  100. true frequency of the (virtual) pair (600 is more noteworthy than 150
  101. + 200 + 250). So converting everything to lowercase reveals
  102. information that might otherwise be obscured.
  103.  
  104. Ideally, a sample should be _enormous_. It should include all the
  105. text you can lay hands on, with the stipulation that that text
  106. actually reflects your real, day-to-day needs. It should be biased
  107. to reflect your actual working conditions (e.g., omit numbers if you
  108. have to have tabular alignment). This is a lot of work...
  109.  
  110. Here's a way of doing it fast:
  111.  
  112. * Accumulate _copies_ of your text files, all in one folder
  113.  
  114. * Drag & Drop them onto Cat o' Seven Tails
  115.  
  116. * Drag & Drop "Concatenated files…" plus your 'biasing' Torquemada
  117.   set(s) onto Torquemada
  118.  
  119. * Drag & Drop "Concatenated files….TQM" onto Pairing Knife
  120.  
  121. * Drag & Drop "Pairing Knife.TXT" onto Word and select Utilites Sort
  122.  
  123. * Pass the list off on the designated KerningDrone and go home
  124.   early (grin)
  125.  
  126.  
  127. That's it... Not the coolest thing I've ever written, but it's a fun
  128. toy with a nice, if short-lived, benefit.
  129.  
  130. Very Best,
  131.  
  132. Greg Swann
  133. 6/10/92
  134.